home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / ab20 / sounds / tools / soundzap.lha / SoundZAP.doc < prev    next >
Text File  |  1992-03-30  |  7KB  |  132 lines
  1. SoundZAP v2.0:
  2.  
  3.  
  4. Description:
  5.     SoundZAP is a program for converting sound files of various formats into
  6.     IFF 8SVX files or RAW sample data.
  7.  
  8. Background:
  9.     One of the amazing things about the Amiga is its incredible sound support.
  10.     Its BUILT-IN sound hardware is capable of playing sound of higher quality
  11.     than most of the add-on sound hardware for other platforms. So when I got
  12.     access to InterNet earlier this year I was amazed that most of the sound
  13.     files posted in the alt.binaries.sounds.* newsgroups were NOT posted by
  14.     Amiga users, and therefore were not in the Amiga standard IFF 8SVX format.
  15.     I then looked around for a program that would convert these files into a
  16.     format that I can use easily (i.e. 8SVX). The largest help came from Dave
  17.     Champion (dgc3@midway.uchicago.edu) who gave me a copy of a program he
  18.     wrote called "mac2raw". But, that program still only gave RAW signed data.
  19.     I wanted 8SVX files. So we hacked around a while working on writing a
  20.     multi-format sound convertor. Dave and I worked for a few weeks on it but
  21.     finally we both got too busy to give it much more thought. Then two months
  22.     or so later I got inspiration! I found ulaw28svx, by Michael Boehnisch
  23.     (billy@uni-paderborn.de) somewhere. It worked great for converting ulawed
  24.     files and it gave me the output I wanted, so I sat down and re-wrote the
  25.     program we had been working on before from scratch. I got the ULAW and RAW
  26.     convertors to work, and before I knew it I had what you now have before
  27.     you!
  28.  
  29. Capabilities:
  30.     This program converts sound files of the following formats: RAW (signed,
  31.     unsigned, and ulaw-ed), .AU files, and .VOC files. (I plan to put an IFF
  32.     reader in so that you can change their frequencies but I haven't had time
  33.     yet. I'll get to it!) It outputs either IFF 8SVX files or RAW data. It auto
  34.     detects the .VOC and .AU headers and converts them appropriately. You can
  35.     force the program into using a certian sample rate for the output file. You
  36.     can also force it ignore any headers and convert the file as if it were
  37.     just RAW data. It can use a variable buffer size and convert samples of any
  38.     size. There are a few other command line options that will be discussed
  39.     later.
  40.  
  41. Command Line Options:
  42.     All options are a minus sign followed by a letter. Some have numerical
  43.     arguments which should follow the letter (no space between the letter
  44.     and the number).
  45.  
  46.         -w    : Output RAW data, not 8SVX
  47.  
  48.         -s    : Toggle signed/unsigned. This only needs to be used if the
  49.                 program makes a mistake and assumes signed data is unsigned or
  50.                 vice versa.
  51.  
  52.         -n    : This will cause the program to only output the VHDR and BODY
  53.                 chunks, and not the AUTH and ANNO chunks. If a sample player
  54.                 seems to choke on a converted sample try using this option.
  55.  
  56.         -f    : Force the program to assume the input data is RAW. Use this if
  57.                 the header of a file is corrupted and SoundZAP is choking on
  58.                 it. You may then have to edit the sample to get rid of any
  59.                 headers or other non-sample data that doesn't get stripped.
  60.  
  61.         -b<n> : This will change the size of the buffer the program uses while
  62.                 converting the sample. If you have only a small amount of
  63.                 memory you may have to use this switch, but remember: the
  64.                 larger the buffer the faster the conversion. The default is
  65.                 50K and n is in K, so "-b1000" would create a 1000 kilobyte
  66.                 (or 1 Megabyte) buffer.
  67.  
  68.         -r<n> : This changes the sample rate for the output data. This switch
  69.                 overrides any headers in the source file. Possible values for
  70.                 n are the following:
  71.                                         5  = 5696  samples/sec
  72.                                         7  = 7596  samples/sec
  73.                                         8  = 8000  samples/sec
  74.                                         11 = 11395 samples/sec
  75.                                         22 = 22790 samples/sec
  76.  
  77.                 This switch will also accept explicit declarations of the
  78.                 sample rate, not just teh above abbreviations. Just enter
  79.                 the sample rate right after the '-r' on the command line.
  80.                 Example: "-r2203" would set the sample rate to 2203 samples
  81.                 per second.
  82.  
  83.                 The default is 11395 samples/sec for RAW data.
  84.  
  85.  
  86. Registration:
  87.     I am not asking for any money for this program. It was not that difficult to
  88.     write and I enjoyed doing it. If YOU feel obligated to send something what
  89.     you could do is send me any information on sound formats that you think would
  90.     be useful for future versions. That would probably be the most helpful thing
  91.     you could do.
  92.  
  93. Updates:
  94.     I will try to keep the most up-to-date versions on ab20.larc.nasa.gov for
  95.     people with FTP access. If you don't have FTP access I can send you the latest
  96.     version via Internet E-Mail. Finally, I can Snail-Mail you the latest version
  97.     if you have no other way of finding it, but you'll have to send me enough money
  98.     to cover the price of a disk and postage.
  99.  
  100.  
  101. Thanks:
  102.     Thanks to Guido, Michael, Brian Foley. See source for why! And I especially
  103.     want to thank Dave who helped TREMENDOUSLY with the first attempt, which was
  104.     the basis for this version. Also thanks to everyone who sent me mail and
  105.     tested the new version of this program.
  106.  
  107.  
  108. Author:
  109.     Michael Cramer (mrc113@psuvm.psu.edu)
  110.  
  111.     You can contact me at the above E-Mail address from September to November
  112.     and from January to April. You can also Snail-Mail me anytime at the
  113.     following address: 1015 Lindbergh Ave.
  114.                        Stroudsburg, PA 18360
  115.  
  116.     Use E-Mail if you can, becasue it's MUCH faster for me.
  117.  
  118. If you find ANY bugs or things you think should be changed contact me and I'll
  119. do my best to fix them. I would especially like someone to check out the .VOC
  120. conversion stuff because it was basically a stab in the dark! Please don't
  121. make any changes to my source, mail me and I'll release a fixed version.
  122.  
  123.  
  124. If you have the specifications and/or a sample of another storage format please
  125. mail it to me. I can only support formats that I have access to, and I don't
  126. have time to look all over the place for different formats. Thanks!
  127.  
  128. See the file "history" for release history and future plans.
  129.  
  130. SoundZAP was compiled with DICE version 2.06.40 in March of 1992.
  131.  
  132.